.TH std::array::rend,std::array::crend 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::array::rend,std::array::crend \- std::array::rend,std::array::crend

.SH Synopsis
   reverse_iterator rend() noexcept;              \fB(1)\fP \fI(since C++11)\fP
                                                      (constexpr since C++17)
   const_reverse_iterator rend() const noexcept;  \fB(2)\fP \fI(since C++11)\fP
                                                      (constexpr since C++17)
   const_reverse_iterator crend() const noexcept; \fB(3)\fP \fI(since C++11)\fP
                                                      (constexpr since C++17)

   Returns a reverse iterator to the element following the last element of the reversed
   array. It corresponds to the element preceding the first element of the non-reversed
   array. This element acts as a placeholder, attempting to access it results in
   undefined behavior.

   range-rbegin-rend.svg

.SH Parameters

   \fI(none)\fP

.SH Return value

   Reverse iterator to the element following the last element.

.SH Complexity

   Constant.

.SH Example


// Run this code

 #include <algorithm>
 #include <array>
 #include <iostream>

 int main()
 {
     std::array<int, 11> a{1, 11, 11, 35, 0, 12, 79, 76, 76, 69, 40};

     // print elements of array in reverse order using const_reverse_iterator`s
     std::for_each(a.crbegin(), a.crend(), [](int e){ std::cout << e << ' '; });
     //              ^^           ^^
     std::cout << '\\n';

     // modify each element of array using non-const reverse_iterator`s
     std::for_each(a.rbegin(), a.rend(), [](int& e){ e += 32; });
     //              ^           ^             ^

     // print elements as chars in reverse order using const_reverse_iterator`s
     std::for_each(a.crbegin(), a.crend(), [](char e){ std::cout << e; });
     //              ^^           ^^          ^^^^
     std::cout << '\\n';
 }

.SH Output:

 40 69 76 76 79 12 0 35 11 11 1
 Hello, C++!

.SH See also

   rbegin  returns a reverse iterator to the beginning
   crbegin \fI(public member function)\fP
   rend    returns a reverse end iterator for a container or array
   crend   \fI(function template)\fP
   \fI(C++14)\fP
